Leadtools Send comments on this topic. | Back to Introduction - All Topics | Help Version 15.3.5
SetRow(Int32,Byte[],Int32,Int32) Method
See Also 
Leadtools Namespace > RasterImage Class > SetRow Method : SetRow(Int32,Byte[],Int32,Int32) Method




row
The number of the row to update. The first row is 0, and the last row is 1 less than the image height.
buffer
Buffer containing the image data. The data is copied exactly as it is stored in the buffer. The buffer should contain uncompressed data regardless of whether the image is compressed or not.
bufferIndex
The zero-based index into the buffer where the set operation should start.
bufferCount
Number of bytes to set. Use the BytesPerLine property of thiss RasterImage to determine the byte count of each line.
Copies a row or more of image data to this RasterImage.

Syntax

Visual Basic (Declaration) 
Public Overloads Function SetRow( _
   ByVal row As Integer, _
   ByVal buffer() As Byte, _
   ByVal bufferIndex As Integer, _
   ByVal bufferCount As Integer _
) As Integer
Visual Basic (Usage)Copy Code
Dim instance As RasterImage
Dim row As Integer
Dim buffer() As Byte
Dim bufferIndex As Integer
Dim bufferCount As Integer
Dim value As Integer
 
value = instance.SetRow(row, buffer, bufferIndex, bufferCount)
C# 
public int SetRow( 
   int row,
   byte[] buffer,
   int bufferIndex,
   int bufferCount
)
Managed Extensions for C++ 
public: int SetRow( 
   int row,
   byte[]* buffer,
   int bufferIndex,
   int bufferCount
) 
C++/CLI 
public:
int SetRow( 
   int row,
   array<byte>^ buffer,
   int bufferIndex,
   int bufferCount
) 

Parameters

row
The number of the row to update. The first row is 0, and the last row is 1 less than the image height.
buffer
Buffer containing the image data. The data is copied exactly as it is stored in the buffer. The buffer should contain uncompressed data regardless of whether the image is compressed or not.
bufferIndex
The zero-based index into the buffer where the set operation should start.
bufferCount
Number of bytes to set. Use the BytesPerLine property of thiss RasterImage to determine the byte count of each line.

Return Value

The number of bytes copied.

Example

For an example, refer to GetRow.

Remarks

The image memory must be locked when you use this method. Normally, you can call Access to lock the memory before starting an operation that uses this method, then call Release when the operation is finished.

You can use the BitsPerPixel property of the image to determine the number of bytes to set the bufferCount parameter. If the image is 8-bit then each byte is an index to the palette. If the image is a 24-bit image, then each three bytes represents one pixel element. Color order is determined by the Order property of the RasterImage object. This value can be RasterByteOrder.Rgb, RasterByteOrder.Bgr, or RasterByteOrder.Romm.

RasterByteOrder.Gray is only valid for 12 and 16-bit grayscale images. Support for 12 and 16-bit grayscale images is only available in the Document/Medical Imaging editions.

For more information, refer to Processing an Image.

Requirements

Target Platforms: Microsoft .NET Framework 2.0, Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also